/*
 * Copyright By Peak3
 * Copyright By c336bf6ff03a756989bb456b5b5e3271228d43ed38461eb5cb5755d17a2fc9b8
 * All rights reserved.
 *
 * If you are not the intended user, you are hereby notified that any use, disclosure, copying, printing, forwarding or
 * dissemination of this property is strictly prohibited. If you have got this file in error, delete it from your system.
 */

package com.vv.tools.modules.message.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.vv.tools.modules.message.model.MessageDTO;
import com.vv.tools.modules.message.model.request.MessageRequest;

import jakarta.servlet.http.HttpServletRequest;

import java.util.List;
import java.util.Map;

/**
 * 留言服务接口
 *
 * @author liwen
 */
public interface MessageService {

    /**
     * 分页查询留言列表（管理员用）
     *
     * @param current 当前页
     * @param size 每页大小
     * @param status 状态筛选
     * @param keyword 关键词搜索
     * @return 留言分页列表
     */
    IPage<MessageDTO> getMessagePage(Long current, Long size, Integer status, String keyword);

    /**
     * 分页查询公开留言列表（用户端）
     *
     * @param current 当前页
     * @param size 每页大小
     * @return 留言分页列表
     */
    IPage<MessageDTO> getPublicMessagePage(Long current, Long size);

    /**
     * 根据ID查询留言详情
     *
     * @param id 留言ID
     * @return 留言DTO
     */
    MessageDTO getMessageById(Long id);

    /**
     * 提交新留言
     *
     * @param request 留言请求参数
     * @param httpRequest HTTP请求对象
     * @return 留言ID
     */
    Long submitMessage(MessageRequest request, HttpServletRequest httpRequest);

    /**
     * 审核留言
     *
     * @param id 留言ID
     * @param status 审核状态：1-通过，2-拒绝
     * @param reply 回复内容
     * @return 是否成功
     */
    Boolean auditMessage(Long id, Integer status, String reply);

    /**
     * 删除留言
     *
     * @param id 留言ID
     * @return 是否成功
     */
    Boolean deleteMessage(Long id);

    /**
     * 置顶/取消置顶留言
     *
     * @param id 留言ID
     * @param isTop 是否置顶：0-否，1-是
     * @return 是否成功
     */
    Boolean topMessage(Long id, Integer isTop);

    /**
     * 点赞留言
     *
     * @param id 留言ID
     * @return 点赞后的数量
     */
    Integer likeMessage(Long id);

    /**
     * 获取留言统计信息
     *
     * @return 统计信息
     */
    Map<String, Object> getMessageStats();

    /**
     * 批量删除留言
     *
     * @param ids 留言ID列表
     * @return 是否成功
     */
    Boolean batchDeleteMessages(List<Long> ids);
}
